GXHandleAlertFilter(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Finder Dialog Box Messages

GXHandleAlertFilter
You need to override the GXHandleAlertEvent message if you are providing custom handling of printing alerts. Your override code of the GXHandleAlertEvent message must match the following formal declaration:
OSErr MyGXHandleAlertFilter (gxJob aJob, gxStatusRecord *aStatus,
                     DialogPtr aDialog, EventRecord *aEventRecord,
                     short *itemHit, Boolean *returnImmed);
ajob
The job object that is associated with the dialog box.
aStatus
A pointer to the status record that describes the alert.
aDialog
A pointer to information about the dialog box that is displaying the alert information.
aEventRecord
A pointer to information about the event that is being handled.
itemHit
A pointer to the ID of the item in the dialog box in which the event occurred.
returnImmed

On return, a Boolean value that is true if the filter procedure completely handled the event (no further event processing needs to be done) and false if the filter procedure did not completely handle the event.

function result
An error code. The value noErr indicates that the operation was successful.

DESCRIPTION
QuickDraw GX sends the GXHandleAlertFilter message when a user-initiated event occurs in a printing alert box.
The default implementation of this message handles events that occur in the the printing alert box. If you have customized the printing alert box, you need to handle those events as necessary.
In your override, you need to check the event. If the status event dismisses the printing alert box, set the returnImmed parameter value to true.

SPECIAL CONSIDERATIONS
You never send the GXHandleAlertFilter message yourself.
If you handle the event, you must totally override the GXHandleAlertFilter message. Otherwise, forward the message so that another message handler can process the event.

RESULT CODES
gxSegmentLoadFailedErr A required code segment could not be found,
or there was not enough memory to load it.
gxPrUserAbortErr The user has canceled printing.

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

GXHandleAlertFilter

DESCRIPTION

SPECIAL CONSIDERATIONS

RESULT CODES gxSegmentLoadFailedErrA required code segment could not be found, or there was not enough memory to load it. gxPrUserAbortErrThe user has canceled printing.

RESULT CODES
gxSegmentLoadFailedErr A required code segment could not be found,
or there was not enough memory to load it.
gxPrUserAbortErr The user has canceled printing.